home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 12 / BBS in a box XII-2.iso / Files II / Prog / M / MacWT 0.04.sit / WT Docs / README-0.04 < prev    next >
Encoding:
Text File  |  1994-05-18  |  5.6 KB  |  160 lines
  1. wt - a portable 3D game engine, version 0.04
  2.  
  3. Copyright (C) 1994 by Chris Laurel
  4.  
  5. Please see the LICENSE file for further details.  You may not distribute
  6. this project without this file (README) and the LICENSE file included.
  7.  
  8. The file gifload.c is covered by a separate license and warranty than the
  9. rest of this project.  Details can be found at the beginning of the file.
  10.  
  11. ---------------------------------------------------------------------------
  12.  
  13.  
  14. This is still a preliminary version of my 3D game engine, wt.  Release 0.04
  15. has primarily portability changes.  I've added in patches contributed by
  16. many different people.  A lot of duplicate patches were submitted--sometimes
  17. I chose the first patch that I got, other times I picked the cleanest one,
  18. and a couple times I apllied the best features of both patches.  I have not
  19. gotten all the patching done yet.  The portability changes that I did make
  20. will mostly affect X11-based platforms.  I have yet to incorporate the changes
  21. for the Macintosh or OS/2 ports.
  22.  
  23. As of this release, wt has been ported to the following platforms:
  24.  
  25.    - Linux
  26.    - OS/2
  27.    - MSDOS
  28.    - Alpha/OSF/1
  29.    - Decstation 3000/Ultrix
  30.    - SGI/Irix
  31.    - HP 7xx/HPUX
  32.    - RS6000/AIX
  33.    - Mac 68xxx
  34.    - Powermac
  35.    - Amiga
  36.  
  37. Notably missing are Windows 3.1 and Windows NT.  If anyone has ported to
  38. one of these platforms, I'd really like to hear about it.
  39.  
  40.  
  41. The following instructions are for getting the wt demo up and running on
  42. a UNIX workstation from the source.  If you have don't have UNIX, or just
  43. don't want to bother with source, you should ftp to magoo.uwsuper.edu and
  44. look in the directory pub/wt/bins.  There are a number of precompiled
  45. versions of the wt demo.  Hopefully, there will be an up to date version
  46. for you computer.
  47.  
  48.  
  49. * Running the wt and xwt demos:
  50.  
  51.     * Edit the makefile (or Imakefile if you'd prefer) and select
  52.         the right definitions for your system.
  53.  
  54.     * If you're using the Imakefile, type 'xmkmf' and then 'make'
  55.         Otherwise you can just type 'make'
  56.  
  57.     * If your compiling for X windows, you will compile 'xwt'  Otherwise
  58.             the name of the executable is just 'wt'
  59.  
  60.     * For xwt, just type 'xwt castle.world'  The keys are:
  61.         forward - up arrow
  62.         backward - down arrow
  63.         turn left - left arrow
  64.         turn right - right arrow
  65.         strafe - slash
  66.         run - shift
  67.         jump - space
  68.         quit - q
  69.  
  70.             Alt or Meta should also be useable as strafe keys, but my
  71.             version of X distributions as the Alt key mapped to something
  72.         else.  
  73.      
  74.     * To run wt in full-screen mode for Linux (using svgalib), you need
  75.         to be root (or make it setuid root first.)
  76.         As root, type 'wt castle.world'  The keys are the same as for the
  77.         X version, except that the slash does not work for strafing.
  78.  
  79.  
  80. * Resources
  81.  
  82.     * A wt mailing list has been started recently.  Topics will include
  83.         improving the engine design and adding features, porting the
  84.         engine to different architectures, and game design using the wt
  85.         graphics engine.  The addresses are:
  86.  
  87.         to subscribe:  wtm-request@magoo.uwsuper.edu
  88.             to post a message: wtm@magoo.uwsuper.edu
  89.  
  90.     * The wt ftp site is magoo.uwsuper.edu.  wt related files will be
  91.         located in the /pub/wt directory.
  92.     
  93.  
  94. * New features in 0.04
  95.  
  96.     * Sky backgrounds
  97.     * Ability to read in GIFs as textures (no support for using GIF
  98.         color maps though.)
  99.     * Preliminary mouse support for Linux full-screen mode.
  100.  
  101.  
  102. * Room for improvement
  103.  
  104.     * Optimizations.  There are some obvious ones that I have not gotten
  105.       around to implementing yet.  I think that the floors code
  106.       can be sped up significantly.  If you know of any improvements to the
  107.       assembly loops in slice.c, *tell me*.  I'm not an Intel assembly
  108.       language guru or anything.
  109.  
  110.     * Code cleanup.  The core of wt is still in development, so some of
  111.       the code surrounding the renderer is hacky test-the-engine stuff.
  112.       Once wt starts developing into a real game, much of the code
  113.       will be reorganized.  wt.c will change completely.
  114.  
  115.     * Better textures.  The wt demo has dull textures.  If you've got
  116.       some freely distributable tileable textures, send me mail.  Even
  117.       though wt is far from becoming a real game, neat textures would
  118.           spice up the demo quite a bit.
  119.  
  120.  
  121. * Future directions:
  122.  
  123.     * I'd like to see wt become a multi-platform client for an
  124.       Internet wide MUD type game.  Or a perhaps a net-wide arcade
  125.       game like Xpilot.  I've got a lot of other more innovative ideas
  126.       but I'd better get the engine done before I start spouting about
  127.       them.
  128.  
  129.  
  130. * Credits
  131.  
  132.     Dan Egnor (egnor@ugcs.caltech.edu) - submitted the first set of
  133.          endian fixes.
  134.     Dave Thomas (dave@thomases.demon.co.uk) - wrote up an Imakefile
  135.     Pietik{inen (pp@lyseo.otol.fi) - RAW mode keyboard and mouse patches
  136.          for the Linux svgalib version.
  137.         Harm Hanemaayer (hhanemaa@cs.ruu.nl) - Patches to linuxvga.c to
  138.          make better use of svgalib.
  139.     Russ Nelson (nelson@crynwr.com) - Created the as yet unincorporated
  140.          Tcl worldfile changes and provided lots of good advice.
  141.     Patrick L. McGillan (pmcgilla@magoo.uwsuper.edu) - Set up the wt
  142.          mailing list and ftp site.
  143.         Thomas Hamren (d0hampe@dtek.chalmers.se) - Provided the GIF code
  144.         Marinos Yannikos (nino@vmars.tuwien.ac.at) - X11 fixes and Sun Sparc
  145.          compatibility fixes
  146.     Joseph Provine (provine@enel.ucalgary.ca) - X11 enhancements
  147.     Ling Thio (H.L.Thio@et.tudelft.nl) - world files and Sun fixes
  148.         Castor Fu (castor@drizzle.stanford.edu) - Alpha portability
  149.  
  150. * Me:
  151.  
  152.     send any comments, ideas, bug reports, etc. to:
  153.  
  154.     Chris Laurel
  155.     home: claurel@mr.net
  156.     work: chrisl@county.lmt.mn.org
  157.     snailmail: 5700 W Lake St, #208
  158.                    St. Louis Park, MN  55416
  159.     phone: (612) 929-9183
  160.